home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / BACKUP / ABWILD92.ZIP;1 / ABWILD.DOC < prev    next >
Encoding:
Text File  |  1992-12-21  |  17.3 KB  |  319 lines
  1. ABWILD v0.92 - Extended Wild-card Batch-File Utility -         Page 1 of 7
  2. ==========================================================================
  3.  
  4.   AAAAAAAA     BBBBBBBB    WW       WW  IIIIII  LL           DDDDDDDDD
  5. AA        AA   BB     BB   WW       WW    II    LL           DD      DD
  6. AA        AA   BB     BB   WW       WW    II    LL           DD       DD
  7. AA        AA   BBBBBBBB    WW       WW    II    LL           DD        DD
  8. AAAAAAAAAAAA   BBBBBBBBB   WW       WW    II    LL           DD        DD
  9. AAAAAAAAAAAA   BB      BB  WW       WW    II    LL           DD        DD
  10. AA        AA   BB      BB  WW   W   WW    II    LL           DD       DD
  11. AA        AA   BB      BB   WW WWW WW     II    LL           DD      DD
  12. AA        AA   BBBBBBBBB     WWW WWW    IIIIII  LLLLLLLLLLL  DDDDDDDDD
  13.  
  14.  
  15. ABWILD version 0.92, Released December, 1992
  16.  
  17. ABWILD - (c)1992, AAB Enterprises, Inc.
  18.                   P.O. Box 42051
  19.                   Mississauga, Ontario, CANADA
  20.                   L5M-4Z4
  21.  
  22. ABWILD is a productivity utility designed for knowledgeable MS-DOS users.
  23.  
  24. ABWILD provides users with a method to QUICKLY and EASILY ...
  25.    1) repeat a command which does not support DOS wild-cards (*,?).
  26.    2) recurse sub-directories to a user-selected level
  27.    3) extend wild-card support to directories.
  28.    4) extend wild-card support to Alphabetic, Numeric, and Other (+,=,;).
  29.    5) create batch files for ...
  30.       i) file compression
  31.      ii) file conversion
  32.     iii) file management
  33.      iv) source compilation
  34.  
  35. ABWILD provides programmers with a method of externalizing code for wild-card
  36. and sub-directory support. They can therefore spend more time concentrating on
  37. the functionality of their program, instead of the "Bells & Whistles".
  38.  
  39. ABWILD permits the repeated execution of another program (or batch-file).
  40. For convenience, this program (or Batch-file) will be referred to as the
  41. Subordinate Program for the remainder of this text.
  42.  
  43. ABWILD v0.92 - Extended Wild-card Batch-File Utility -         Page 2 of 7
  44. ==========================================================================
  45. -------------------------------------------------------------------------------
  46. ABWILD v0.92 => Wild-card Batch-file Utility - (c)1992, AAB Enterprises, Inc.
  47. *** ABWILD is NOT Free or Public Domain!  It is UNREGISTERED Shareware! ***
  48. You are encouraged to distribute ABWILD to your friends and co-workers.
  49. ABWILD must be distributed in its entirety, for no charge.
  50. Distributors may charge only a reasonable copying fee for ABWILD.
  51. Fees paid to other than AAB Enterprises, Inc. do NOT include registration.
  52. *** You must NOT Modify ABWILD! *** To do so is PLAGIARISM! ***
  53. AAB Enterprises, Inc assumes NO RESPONSIBILITY for loss of Data, Programs,
  54. Time, etc. caused by ABWILD. Use constitutes acceptance of this clause.
  55. You are hereby granted a limited licence to use ABWILD v0.92 for a 30 day
  56. evaluation. After 30 days, you must REGISTER or REMOVE it from your system.
  57.  
  58. Registration provides...
  59.    1- Most recent, REGISTERED version of ABWILD without this Screen and Delay.
  60.    2- Complete, Up-to-Date & Printed Documentation for ABWILD.
  61.    3- Shareware versions of other Software Titles from AAB Enterprises, Inc.
  62.    4- Free BBS support (E.T.A. Summer/1993).
  63.    5- Immunity from Prosecution, A Clear Conscience and a Good Example.
  64. *** Support Shareware!  $20/copy Registration Fee!  (plus $1/Node, $50max) ***
  65. AAB Enterprises, Inc., P.O.Box 42051, Mississauga, Ontario, CANADA, L5M-4Z4
  66.  
  67.   Press any key...  (ESC=Abort)
  68. -------------------------------------------------------------------------------
  69.  
  70. This opening screen shown above contains information pertinent to the Shareware
  71. version of ABWILD. REGISTERED copies will only display this screen upon request.
  72.  
  73. The last line of this screen...
  74.   Press any key...  (ESC=Abort)
  75.                            ...will appear only after five seconds have elapsed.
  76.  
  77. This screen, the five second delay, and the requirement to press a key are
  78. the only restrictions placed on the Shareware version of this utility.
  79. ABWILD is NOT crippled in any way, and retains all the functionality of the
  80. REGISTERED version. This is the way I've chosen to encourage consistent users
  81. to purchase a registered version of this program. Therefore, please do NOT
  82. write requesting that I remove it. If you don't like it, REGISTER!
  83.  
  84. ***************************************************************************
  85. *** Do NOT attempt to modify ABWILD. To do so would involve PLAGIARISM. ***
  86. ***************************************************************************
  87.  
  88. Although not crippled, ABWILD does contain protection against modification.
  89. The protection will also prevent corrupted versions of ABWILD from being
  90. accidentally distributed due to Disk-Errors. If ABWILD runs at all, you can
  91. be fairly certain that you have an unmodified version.
  92.  
  93. At this time, the protection is NOT complete, so do NOT assume ABWILD is 
  94. free of viruses. As a normal precaution, ALWAYS use a virus scanning utility
  95. on any new programs before installation. This includes off-the-shelf, 
  96. shrink-wrapped software. It has happened before, it will happen again.
  97. AAB Enterprises, Inc. has scanned ABWILD for viruses prior to release.
  98.  
  99. ABWILD v0.92 - Extended Wild-card Batch-File Utility -         Page 3 of 7
  100. ==========================================================================
  101.  
  102. The purpose of ABWILD, as mentioned above, is to provide extended wild-card
  103. support to Subordinate Programs which either do not have it at all or do not
  104. have enough of it.
  105.  
  106. The extended part comes from the fact that ABWILD permits the use of three 
  107. additional wild-card characters (ie... '+', '=' and ';'). While the normal
  108. DOS wild-cards of * and ? match ANY character in the appropriate position,
  109. the ABWILD extended wild-cards match characters selectively. To explain...
  110.    i) '+' will match only Alphabetic characters.
  111.   ii) '=' will match only Numeric characters.
  112.  iii) ';' will match only characters which are neither Alphabetic or Numeric.
  113.  
  114. In some cases, a Subordinate Program will utilize one or more of these ABWILD 
  115. extended wild-card characters as part of its options. If you are using such a
  116. program under ABWILD, the Subordinate Program's option(s) will be interpreted as
  117. File-Description(s) containing wild-cards and ABWILD will operate on it 
  118. accordingly. This, of course, will cause ABWILD to output undesirable results. 
  119. To avoid this problem, the use of ABWILD extended wild-cards is an option 
  120. and may be disabled using the No-Wilder Option (ie, /NW).
  121.  
  122. Additionally, the Ignore-String option (/ISxxx) can be used to instruct
  123. ABWILD to ignore an individual parameter for the purposes of File-Description 
  124. modification. In this way, the ABWILD Extended Wild-card characters can still 
  125. be used with programs which use these characters as part of their options.
  126.  
  127. The Syntax for the ABWILD command line is very forgiving. The same can
  128. NOT be said of any program which is executed under ABWILD. ABWILD can NOT be
  129. expected to know of and correct the Syntax for every program the user 
  130. may choose to use with it. Therefore, you are responsible for knowing and
  131. using the correct Syntax of the Subordinate Program.
  132.  
  133. No spacing is required in the ABWILD Command-Line Options. However, as shown
  134. in the help screen, each Option must be preceded by a slash (ie... '/').
  135. ABWILD automatically translates its own options from lower to upper case, 
  136. but, does NOT translate the options &/ parameters of the Subordinate Program.
  137. Therefore, once again, you are responsible for knowing whether the Subordinate 
  138. Program requires upper, lower or mixed case in its options.
  139.  
  140. ABWILD permits the entry of the Subordinate Program and its parameters 3 ways.
  141.    i) append the Subordinate Program, Parameters and Options to the end
  142.       of the ABWILD Command-Line.
  143.   ii) from a Disk-file whose name is specified in the ABWILD Command-Line 
  144.       using the Input-File-name option (ie, /IFxxx). 
  145.  iii) from the keyboard, after executing ABWILD with the Input-File-name
  146.       option which specifies the CONSOLE as the input device (ie, /IFcon).
  147.  
  148. The second and third methods permit the entry of multiple Subordinate Programs
  149. and their associated Parameters and Options. While the first method permits
  150. you to vary ABWILD's options for each Subordinate Program, the second and 
  151. third methods cause ABWILD to retain the initial options for each of them.
  152.  
  153. Please note that use of the Input-File-name option (ie, /IFxxx) causes all 
  154. non-ABWILD options on the Command-Line to be ignored. This means that the
  155. first Subordinate Program input method described above can NOT be combined 
  156. with the second or the third method.
  157.  
  158. ABWILD v0.92 - Extended Wild-card Batch-File Utility -         Page 4 of 7
  159. ==========================================================================
  160.  
  161. Something similar to the ABWILD Help screen is shown below. 
  162. Subsequently, each option will be explained briefly.
  163.  
  164. -------------------------------------------------------------------------------
  165. ABWILD v0.92 => Wild-card Batch-file Utility - (c)1992, AAB Enterprises, Inc.
  166.  Purpose: Provide extended Wild-card support using Batch-files.
  167. *** ABWILD is NOT Free or Public Domain!  It is UNREGISTERED Shareware! ***
  168.   Method: i) Find Wild-Cards(*?+=;) in Command-Line File-Descriptions.
  169.          ii) Generate Batch-File with NO Wild-Cards in File-Descriptions.
  170.         iii) Optionally Execute and Delete Batch-File.
  171.  
  172.   Syntax: ABWILD [/options] PROGRAM FileDesc [FileDesc2] [-options]
  173.  
  174.  Options: /?=Help        /M=Mono          /I=Info       Wild.... {*} all ASCII
  175.           /A=Append    !/NA=No-Append                   Wild.... {?} any ASCII
  176.          !/B=Break      /NB=No-Break-on-error                   /{+} any Alpha
  177.  ! is    !/D=Delete     /ND=No-Delete                   Wilder < {=} any Digit
  178. default   /E=Echo      !/NE=No-Echo                             \{;} any Other
  179.  value   !/F=Files      /NF=No-Files        /P#=Primary-file-desc.......1=Dflt
  180.          !/P=Path-add   /NP=No-Path-add     /L#=Levels-to-recurse......99=Dflt
  181.           /R=Recurse   !/NR=No-Recurse      /S#=Sub-dir-format....3/2/1/0=Dflt
  182.           /V=Verbose   !/NV=No-Verbose    /ISxx=Ignore-String.......repeatable
  183.          !/W=Wilder     /NW=No-Wilder     /IFxx=Input-File............con=Dflt
  184.          !/X=eXecute    /NX=No-eXecute    /OFxx=Output-File.......ABW.BAT=Dflt
  185. *** Support Shareware!  $20/copy Registration Fee!  (plus $1/Node, $50max) ***
  186. AAB Enterprises, Inc., P.O.Box 42051, Mississauga, Ontario, CANADA, L5M-4Z4
  187. -------------------------------------------------------------------------------
  188.  
  189. ABWILD v0.92 - Extended Wild-card Batch-File Utility -         Page 5 of 7
  190. ==========================================================================
  191.  
  192. ABWILD does not change Drives, Directories or Environment Variables during
  193. execution. ABWILD requires neither Expanded or Extended memory and will
  194. execute properly on a system with only 256kB. 
  195.  
  196. ABWILD uses only the DOS internal DIR command to perform its functions
  197. and does not utilize the MS-DOSv5.0 /S enhancement to DIR. ABWILD will
  198. therefore work with older and obscure versions of MS-DOS. ABWILD has been
  199. tested with NEC-DOSv3.2, NEC-DOSv3.3, IBM-DOSv4.01 and MS-DOSv5.00. Since 
  200. ABWILD can be used to execute a program hundreds of times, a Disk-Cache
  201. and/or RAM-Drive are recommended.
  202.  
  203. ABWILD v0.92 - Extended Wild-card Batch-File Utility -         Page 6 of 7
  204. ==========================================================================
  205.  
  206. At this point, each option will be explained briefly.
  207.  
  208. *NB!*   Options preceded by the exclamation point are defaults and need not
  209.         be entered. They are included for documentation purposes and clarity.
  210.         All ABWILD options may be repeated on the Command-Line as many times
  211.         as space permits. This is only useful with the Ignore-String option
  212.         (ie, /ISxxx). Spacing between ABWILD is not required. Appropriate
  213.         punctuation for the Sub-ordinate program is dependant upon its
  214.         own individual requirements.
  215.  
  216. Option  Description
  217. /?      Displays the Help Screen
  218. /I      Displays the Info Screen
  219. /M      Uses only Monochrome compatible colours.
  220. /A      Appends Subordinate commands to existing Output-File.
  221. /NA     Clears Output-File prior to appending of Subordinate commands.
  222. /B      Breaks execution if a run-time error occurs in the Sub-ordinate program.
  223. /NB     No Break. Ignores run-time errors in the Sub-ordinate Program.
  224. /D      Last Command in Output-File causes it to delete itself.
  225. /ND     The delete command is NOT inserted into the Output-File.
  226. /E      The first command in the Output-File enables echo during execution.
  227. /NE     The first command in the Output-File disables echo during execution.
  228. /F      Includes Files to match Wild-cards. (related to /S#)
  229. /NF     Excludes Files from matching wild-cards.
  230. /P      Adds same path to non-Primary wild-card file-descriptions without one.
  231. /NP     Does not add the same path to non-Primary wild-card file-descriptions.
  232. /R      Enables Sub-directory recursion. (also sets /L#=99)
  233. /NR     Disables Sub-directory recursion. (also sets /L#=0)
  234. /V      Enables ABWILD's progress display.
  235. /NV     Disables ABWILD's progress display.
  236. /W      Enables ABWILD's Extended Wild-cards (ie, '+', '=' and ';')
  237. /NW     Disables ABWILD's Extended Wild-cards.
  238. /X      Executes Output-File after generating it.
  239. /NX     Does not execute Output-File.
  240. /L#     Specifies maximum number of levels of sub-directories to penetrate.
  241.         (if 0, also sets /NR. if > 0, also sets /R, default=99)
  242. /S#     Specfies type of Sub-Directory Name Matching (3, 2, 1 or 0=Default)
  243.         -0 Sub-Directory Names not included
  244.         -1 Sub-Directory Names included
  245.         -2 Sub-Directory Names and Back-Slash included
  246.         -3 Sub-Directory Names, Back-Slash and Wild-cards included
  247. /P#     Specifies which Wild-card File-Description is to be considered primary
  248.         when more than one is specified. Parameters and options ignored.
  249.         From left to right, the name of the Subordinate Program is offset 0.
  250. /ISxxx  Specifies a string which is to be ignored for the purposes of
  251.         determining Wild-card File-Descriptions.  
  252. /IFxxx  Specifies the name of and Input-File which contains one or more 
  253.         Wild-card File-Description Subordinate Program Command-Lines.
  254. /OFxxx  Specifies the name of the Output-File into which the non Wild-card
  255.         File-Description Subordinate Program Command-Lines are to be inserted.
  256.         This file will be of the DOS BATch file format and may be executed.
  257.         Therefore, the files extension should be .BAT !
  258.  
  259. ABWILD v0.92 - Extended Wild-card Batch-File Utility -         Page 7 of 7
  260. ===========================================================================
  261.  
  262. The examples below assume ABWILD, ABCHKSUM and PKZIP have been installed
  263. to a Sub-directory on the Hard-drive and a path to the appropriate 
  264. Sub-directory exists.
  265.  
  266. ABWILD comes with ABCHKSUM, a utility to generate checksums for a file. 
  267. ABCHKSUM does NOT support wild-cards and is therefore suitable as a test 
  268. program for ABWILD. ABCHKSUM outputs its results to the screen, and this
  269. can be re-directed to a file if desired.
  270.  
  271. For example...
  272.  
  273. C:\>ABWILD /r/v/nd/nx ABCHKSUM c:\+++*.COM ABCHKSUM.TXT
  274.  
  275. Will generate a Batch-File called ABW.BAT in the CURRENT directory.
  276. Will NOT execute it and when ABW.BAT is executed, will NOT delete itself.
  277. Will recurse ALL Sub-Directories starting at C:\
  278. Will find only .COM files whose name begins with at least 3 Alphabetics.
  279. Will append the results of each execution onto a file called ABCHKSUM.TXT
  280.      in the CURRENT Directory.
  281.  
  282. Since ABWILD was originally designed to help with PKZIP, an example is
  283. probably warranted.
  284.  
  285. Regardless of how a system changes, a batch file containing these 
  286. statements will compress an entire system of four partitions into 
  287. individual .ZIP files corresponding to the name of the Sub-Directories
  288. they contain. This can be performed before backing up to Tape. This is
  289. useful if your tape drive software does not perform compression.
  290.  
  291. ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P *.zip c:\*.* -x*.zip
  292. ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P *.zip d:\*.* -x*.zip
  293. ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P *.zip e:\*.* -x*.zip
  294. ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P *.zip f:\*.* -x*.zip
  295.  
  296. Since the Path-add option (ie, /P) is a default, the .ZIP files will end 
  297. up in the root directories of the corresponding Hard-drive Partitions. 
  298. However, since there may not be enough free disk space to handle these
  299. large .ZIP files, the destinations can be changed. For example...
  300.  
  301. ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P f:\*.zip c:\*.* -x*.zip
  302. ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P f:\*.zip d:\*.* -x*.zip
  303. ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P f:\*.zip e:\*.* -x*.zip
  304. ABWILD /v /p2 /s3 /nr /is-x*.zip PKZIP -r -P e:\*.zip f:\*.* -x*.zip
  305.  
  306. Since the add-Path option only operates on Wild-card File-Descriptions
  307. which specify neither Drive or Path, it is not necessary to specify /NP.
  308.  
  309. This documentation will be expanded upon in future releases.
  310. For now, 
  311.          THAT'S ALL FOLKS!
  312.  
  313. *** ABWILD is NOT Free or Public Domain!  It is UNREGISTERED Shareware! ***
  314. *** Support Shareware!  $20/copy Registration Fee!  (plus $1/Node, $50max) ***
  315. AAB Enterprises, Inc., P.O.Box 42051, Mississauga, Ontario, CANADA, L5M-4Z4
  316.  
  317.  
  318.  
  319.